home *** CD-ROM | disk | FTP | other *** search
/ Aminet 34 / Aminet 34 (2000)(Schatztruhe)[!][Dec 1999].iso / Aminet / dev / lang / Python152_Src.lha / Python152_Source / Python / bltinmodule.c next >
Encoding:
C/C++ Source or Header  |  1999-04-25  |  56.7 KB  |  2,553 lines
  1. /***********************************************************
  2. Copyright 1991-1995 by Stichting Mathematisch Centrum, Amsterdam,
  3. The Netherlands.
  4.  
  5.                         All Rights Reserved
  6.  
  7. Permission to use, copy, modify, and distribute this software and its
  8. documentation for any purpose and without fee is hereby granted,
  9. provided that the above copyright notice appear in all copies and that
  10. both that copyright notice and this permission notice appear in
  11. supporting documentation, and that the names of Stichting Mathematisch
  12. Centrum or CWI or Corporation for National Research Initiatives or
  13. CNRI not be used in advertising or publicity pertaining to
  14. distribution of the software without specific, written prior
  15. permission.
  16.  
  17. While CWI is the initial source for this software, a modified version
  18. is made available by the Corporation for National Research Initiatives
  19. (CNRI) at the Internet address ftp://ftp.python.org.
  20.  
  21. STICHTING MATHEMATISCH CENTRUM AND CNRI DISCLAIM ALL WARRANTIES WITH
  22. REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF
  23. MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH
  24. CENTRUM OR CNRI BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL
  25. DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
  26. PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
  27. TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  28. PERFORMANCE OF THIS SOFTWARE.
  29.  
  30. ******************************************************************/
  31.  
  32. /* Built-in functions */
  33.  
  34. #include "Python.h"
  35.  
  36. #include "node.h"
  37. #include "compile.h"
  38. #include "eval.h"
  39.  
  40. #include "mymath.h"
  41.  
  42. #include <ctype.h>
  43.  
  44. #ifdef HAVE_UNISTD_H
  45. #include <unistd.h>
  46. #endif
  47.  
  48. /* Forward */
  49. #include "protos/bltinmodule.h"
  50. static PyObject *filterstring Py_PROTO((PyObject *, PyObject *));
  51. static PyObject *filtertuple  Py_PROTO((PyObject *, PyObject *));
  52.  
  53. static PyObject *
  54. builtin___import__(self, args)
  55.     PyObject *self;
  56.     PyObject *args;
  57. {
  58.     char *name;
  59.     PyObject *globals = NULL;
  60.     PyObject *locals = NULL;
  61.     PyObject *fromlist = NULL;
  62.  
  63.     if (!PyArg_ParseTuple(args, "s|OOO:__import__",
  64.             &name, &globals, &locals, &fromlist))
  65.         return NULL;
  66.     return PyImport_ImportModuleEx(name, globals, locals, fromlist);
  67. }
  68.  
  69. static char import_doc[] =
  70. "__import__(name, globals, locals, fromlist) -> module\n\
  71. \n\
  72. Import a module.  The globals are only used to determine the context;\n\
  73. they are not modified.  The locals are currently unused.  The fromlist\n\
  74. should be a list of names to emulate ``from name import ...'', or an\n\
  75. empty list to emulate ``import name''.\n\
  76. When importing a module from a package, note that __import__('A.B', ...)\n\
  77. returns package A when fromlist is empty, but its submodule B when\n\
  78. fromlist is not empty.";
  79.  
  80.  
  81. static PyObject *
  82. builtin_abs(self, args)
  83.     PyObject *self;
  84.     PyObject *args;
  85. {
  86.     PyObject *v;
  87.  
  88.     if (!PyArg_ParseTuple(args, "O:abs", &v))
  89.         return NULL;
  90.     return PyNumber_Absolute(v);
  91. }
  92.  
  93. static char abs_doc[] =
  94. "abs(number) -> number\n\
  95. \n\
  96. Return the absolute value of the argument.";
  97.  
  98.  
  99. static PyObject *
  100. builtin_apply(self, args)
  101.     PyObject *self;
  102.     PyObject *args;
  103. {
  104.     PyObject *func, *alist = NULL, *kwdict = NULL;
  105.     PyObject *t = NULL, *retval = NULL;
  106.  
  107.     if (!PyArg_ParseTuple(args, "O|OO:apply", &func, &alist, &kwdict))
  108.         return NULL;
  109.     if (alist != NULL) {
  110.         if (!PyTuple_Check(alist)) {
  111.             if (!PySequence_Check(alist)) {
  112.                 PyErr_SetString(PyExc_TypeError,
  113.                     "apply() 2nd argument must be a sequence");
  114.                 return NULL;
  115.             }
  116.             t = PySequence_Tuple(alist);
  117.             if (t == NULL)
  118.                 return NULL;
  119.             alist = t;
  120.         }
  121.     }
  122.     if (kwdict != NULL && !PyDict_Check(kwdict)) {
  123.         PyErr_SetString(PyExc_TypeError,
  124.                "apply() 3rd argument must be dictionary");
  125.         goto finally;
  126.     }
  127.     retval = PyEval_CallObjectWithKeywords(func, alist, kwdict);
  128.   finally:
  129.     Py_XDECREF(t);
  130.     return retval;
  131. }
  132.  
  133. static char apply_doc[] =
  134. "apply(function, args[, kwargs]) -> value\n\
  135. \n\
  136. Call a function with positional arguments taken from the tuple args,\n\
  137. and keyword arguments taken from the optional dictionary kwargs.";
  138.  
  139.  
  140. static PyObject *
  141. builtin_buffer(self, args)
  142.     PyObject *self;
  143.     PyObject *args;
  144. {
  145.     PyObject *ob;
  146.     int offset = 0;
  147.     int size = Py_END_OF_BUFFER;
  148.  
  149.     if ( !PyArg_ParseTuple(args, "O|ii:buffer", &ob, &offset, &size) )
  150.         return NULL;
  151.     return PyBuffer_FromObject(ob, offset, size);
  152. }
  153.  
  154. static char buffer_doc[] =
  155. "buffer(object [, offset[, size]) -> object\n\
  156. \n\
  157. Creates a new buffer object which references the given object.\n\
  158. The buffer will reference a slice of the target object from the\n\
  159. start of the object (or at the specified offset). The slice will\n\
  160. extend to the end of the target object (or with the specified size).";
  161.  
  162.  
  163. static PyObject *
  164. builtin_callable(self, args)
  165.     PyObject *self;
  166.     PyObject *args;
  167. {
  168.     PyObject *v;
  169.  
  170.     if (!PyArg_ParseTuple(args, "O:callable", &v))
  171.         return NULL;
  172.     return PyInt_FromLong((long)PyCallable_Check(v));
  173. }
  174.  
  175. static char callable_doc[] =
  176. "callable(object) -> Boolean\n\
  177. \n\
  178. Return whether the object is callable (i.e., some kind of function).\n\
  179. Note that classes are callable, as are instances with a __call__() method.";
  180.  
  181.  
  182. static PyObject *
  183. builtin_filter(self, args)
  184.     PyObject *self;
  185.     PyObject *args;
  186. {
  187.     PyObject *func, *seq, *result;
  188.     PySequenceMethods *sqf;
  189.     int len;
  190.     register int i, j;
  191.  
  192.     if (!PyArg_ParseTuple(args, "OO:filter", &func, &seq))
  193.         return NULL;
  194.  
  195.     if (PyString_Check(seq)) {
  196.         PyObject *r = filterstring(func, seq);
  197.         return r;
  198.     }
  199.  
  200.     if (PyTuple_Check(seq)) {
  201.         PyObject *r = filtertuple(func, seq);
  202.         return r;
  203.     }
  204.  
  205.     sqf = seq->ob_type->tp_as_sequence;
  206.     if (sqf == NULL || sqf->sq_length == NULL || sqf->sq_item == NULL) {
  207.         PyErr_SetString(PyExc_TypeError,
  208.                "argument 2 to filter() must be a sequence type");
  209.         goto Fail_2;
  210.     }
  211.  
  212.     if ((len = (*sqf->sq_length)(seq)) < 0)
  213.         goto Fail_2;
  214.  
  215.     if (PyList_Check(seq) && seq->ob_refcnt == 1) {
  216.         Py_INCREF(seq);
  217.         result = seq;
  218.     }
  219.     else {
  220.         if ((result = PyList_New(len)) == NULL)
  221.             goto Fail_2;
  222.     }
  223.  
  224.     for (i = j = 0; ; ++i) {
  225.         PyObject *item, *good;
  226.         int ok;
  227.  
  228.         if ((item = (*sqf->sq_item)(seq, i)) == NULL) {
  229.             if (PyErr_ExceptionMatches(PyExc_IndexError)) {
  230.                 PyErr_Clear();
  231.                 break;
  232.             }
  233.             goto Fail_1;
  234.         }
  235.  
  236.         if (func == Py_None) {
  237.             good = item;
  238.             Py_INCREF(good);
  239.         }
  240.         else {
  241.             PyObject *arg = Py_BuildValue("(O)", item);
  242.             if (arg == NULL)
  243.                 goto Fail_1;
  244.             good = PyEval_CallObject(func, arg);
  245.             Py_DECREF(arg);
  246.             if (good == NULL) {
  247.                 Py_DECREF(item);
  248.                 goto Fail_1;
  249.             }
  250.         }
  251.         ok = PyObject_IsTrue(good);
  252.         Py_DECREF(good);
  253.         if (ok) {
  254.             if (j < len) {
  255.                 if (PyList_SetItem(result, j++, item) < 0)
  256.                     goto Fail_1;
  257.             }
  258.             else {
  259.                 int status = PyList_Append(result, item);
  260.                 j++;
  261.                 Py_DECREF(item);
  262.                 if (status < 0)
  263.                     goto Fail_1;
  264.             }
  265.         } else {
  266.             Py_DECREF(item);
  267.         }
  268.     }
  269.  
  270.  
  271.     if (j < len && PyList_SetSlice(result, j, len, NULL) < 0)
  272.         goto Fail_1;
  273.  
  274.     return result;
  275.  
  276. Fail_1:
  277.     Py_DECREF(result);
  278. Fail_2:
  279.     return NULL;
  280. }
  281.  
  282. static char filter_doc[] =
  283. "filter(function, sequence) -> list\n\
  284. \n\
  285. Return a list containing those items of sequence for which function(item)\n\
  286. is true.  If function is None, return a list of items that are true.";
  287.  
  288.  
  289. static PyObject *
  290. builtin_chr(self, args)
  291.     PyObject *self;
  292.     PyObject *args;
  293. {
  294.     long x;
  295.     char s[1];
  296.  
  297.     if (!PyArg_ParseTuple(args, "l:chr", &x))
  298.         return NULL;
  299.     if (x < 0 || x >= 256) {
  300.         PyErr_SetString(PyExc_ValueError,
  301.                 "chr() arg not in range(256)");
  302.         return NULL;
  303.     }
  304.     s[0] = (char)x;
  305.     return PyString_FromStringAndSize(s, 1);
  306. }
  307.  
  308. static char chr_doc[] =
  309. "chr(i) -> character\n\
  310. \n\
  311. Return a string of one character with ordinal i; 0 <= i < 256.";
  312.  
  313.  
  314. static PyObject *
  315. builtin_cmp(self, args)
  316.     PyObject *self;
  317.     PyObject *args;
  318. {
  319.     PyObject *a, *b;
  320.     int c;
  321.  
  322.     if (!PyArg_ParseTuple(args, "OO:cmp", &a, &b))
  323.         return NULL;
  324.     if (PyObject_Cmp(a, b, &c) < 0)
  325.         return NULL;
  326.     return PyInt_FromLong((long)c);
  327. }
  328.  
  329. static char cmp_doc[] =
  330. "cmp(x, y) -> integer\n\
  331. \n\
  332. Return negative if x<y, zero if x==y, positive if x>y.";
  333.  
  334.  
  335. static PyObject *
  336. builtin_coerce(self, args)
  337.     PyObject *self;
  338.     PyObject *args;
  339. {
  340.     PyObject *v, *w;
  341.     PyObject *res;
  342.  
  343.     if (!PyArg_ParseTuple(args, "OO:coerce", &v, &w))
  344.         return NULL;
  345.     if (PyNumber_Coerce(&v, &w) < 0)
  346.         return NULL;
  347.     res = Py_BuildValue("(OO)", v, w);
  348.     Py_DECREF(v);
  349.     Py_DECREF(w);
  350.     return res;
  351. }
  352.  
  353. static char coerce_doc[] =
  354. "coerce(x, y) -> None or (x1, y1)\n\
  355. \n\
  356. When x and y can be coerced to values of the same type, return a tuple\n\
  357. containing the coerced values.  When they can't be coerced, return None.";
  358.  
  359.  
  360. static PyObject *
  361. builtin_compile(self, args)
  362.     PyObject *self;
  363.     PyObject *args;
  364. {
  365.     char *str;
  366.     char *filename;
  367.     char *startstr;
  368.     int start;
  369.  
  370.     if (!PyArg_ParseTuple(args, "sss:compile", &str, &filename, &startstr))
  371.         return NULL;
  372.     if (strcmp(startstr, "exec") == 0)
  373.         start = Py_file_input;
  374.     else if (strcmp(startstr, "eval") == 0)
  375.         start = Py_eval_input;
  376.     else if (strcmp(startstr, "single") == 0)
  377.         start = Py_single_input;
  378.     else {
  379.         PyErr_SetString(PyExc_ValueError,
  380.            "compile() mode must be 'exec' or 'eval' or 'single'");
  381.         return NULL;
  382.     }
  383.     return Py_CompileString(str, filename, start);
  384. }
  385.  
  386. static char compile_doc[] =
  387. "compile(source, filename, mode) -> code object\n\
  388. \n\
  389. Compile the source string (a Python module, statement or expression)\n\
  390. into a code object that can be executed by the exec statement or eval().\n\
  391. The filename will be used for run-time error messages.\n\
  392. The mode must be 'exec' to compile a module, 'single' to compile a\n\
  393. single (interactive) statement, or 'eval' to compile an expression.";
  394.  
  395.  
  396. #ifndef WITHOUT_COMPLEX
  397.  
  398. static PyObject *
  399. complex_from_string(v)
  400.     PyObject *v;
  401. {
  402.     extern double strtod Py_PROTO((const char *, char **));
  403.     char *s, *start, *end;
  404.     double x=0.0, y=0.0, z;
  405.     int got_re=0, got_im=0, done=0;
  406.     int digit_or_dot;
  407.     int sw_error=0;
  408.     int sign;
  409.     char buffer[256]; /* For errors */
  410.  
  411.     start = s = PyString_AS_STRING(v);
  412.  
  413.     /* position on first nonblank */
  414.     while (*s && isspace(Py_CHARMASK(*s)))
  415.         s++;
  416.     if (s[0] == '\0') {
  417.         PyErr_SetString(PyExc_ValueError,
  418.                 "empty string for complex()");
  419.         return NULL;
  420.     }
  421.  
  422.     z = -1.0;
  423.     sign = 1;
  424.     do {
  425.     
  426.         switch (*s) {
  427.  
  428.         case '\0':
  429.             if (s-start != PyString_GET_SIZE(v)) {
  430.                 PyErr_SetString(
  431.                     PyExc_ValueError,
  432.                     "null byte in argument for complex()");
  433.                 return NULL;
  434.             }
  435.             if(!done) sw_error=1;
  436.             break;
  437.                         
  438.         case '-':
  439.             sign = -1;
  440.                 /* Fallthrough */
  441.         case '+':
  442.             if (done)  sw_error=1;
  443.             s++;
  444.             if  (  *s=='\0'||*s=='+'||*s=='-'  ||
  445.                    isspace(Py_CHARMASK(*s))  )  sw_error=1;
  446.             break;
  447.  
  448.         case 'J':
  449.         case 'j':
  450.             if (got_im || done) {
  451.                 sw_error = 1;
  452.                 break;
  453.             }
  454.             if  (z<0.0) {
  455.                 y=sign;
  456.             }
  457.             else{
  458.                 y=sign*z;
  459.             }
  460.             got_im=1;
  461.             s++;
  462.             if  (*s!='+' && *s!='-' )
  463.                 done=1;
  464.             break;
  465.  
  466.         default:
  467.             if (isspace(Py_CHARMASK(*s))) {
  468.                 while (*s && isspace(Py_CHARMASK(*s)))
  469.                     s++;
  470.                 if (s[0] != '\0')
  471.                     sw_error=1;
  472.                 else
  473.                     done = 1;
  474.                 break;
  475.             }
  476.             digit_or_dot =
  477.                 (*s=='.' || isdigit(Py_CHARMASK(*s)));
  478.             if  (done||!digit_or_dot) {
  479.                 sw_error=1;
  480.                 break;
  481.             }
  482.             errno = 0;
  483.             PyFPE_START_PROTECT("strtod", return 0)
  484.                 z = strtod(s, &end) ;
  485.             PyFPE_END_PROTECT(z)
  486.                 if (errno != 0) {
  487.                     sprintf(buffer,
  488.                       "float() out of range: %.150s", s);
  489.                     PyErr_SetString(
  490.                         PyExc_ValueError,
  491.                         buffer);
  492.                     return NULL;
  493.                 }
  494.             s=end;
  495.             if  (*s=='J' || *s=='j') {
  496.                             
  497.                 break;
  498.             }
  499.             if  (got_re) {
  500.                 sw_error=1;
  501.                 break;
  502.             }
  503.  
  504.                 /* accept a real part */
  505.             x=sign*z;
  506.             got_re=1;
  507.             if  (got_im)  done=1;
  508.             z = -1.0;
  509.             sign = 1;
  510.             break;
  511.                     
  512.         }  /* end of switch  */
  513.  
  514.     } while (*s!='\0' && !sw_error);
  515.  
  516.     if (sw_error) {
  517.         PyErr_SetString(PyExc_ValueError,
  518.                 "malformed string for complex()");
  519.         return NULL;
  520.     }
  521.  
  522.     return PyComplex_FromDoubles(x,y);
  523. }
  524.  
  525. static PyObject *
  526. builtin_complex(self, args)
  527.     PyObject *self;
  528.     PyObject *args;
  529. {
  530.     PyObject *r, *i, *tmp;
  531.     PyNumberMethods *nbr, *nbi = NULL;
  532.     Py_complex cr, ci;
  533.     int own_r = 0;
  534.  
  535.     i = NULL;
  536.     if (!PyArg_ParseTuple(args, "O|O:complex", &r, &i))
  537.         return NULL;
  538.     if (PyString_Check(r))
  539.         return complex_from_string(r);
  540.     if ((nbr = r->ob_type->tp_as_number) == NULL ||
  541.         nbr->nb_float == NULL ||
  542.         (i != NULL &&
  543.          ((nbi = i->ob_type->tp_as_number) == NULL ||
  544.           nbi->nb_float == NULL))) {
  545.         PyErr_SetString(PyExc_TypeError,
  546.                "complex() argument can't be converted to complex");
  547.         return NULL;
  548.     }
  549.     /* XXX Hack to support classes with __complex__ method */
  550.     if (PyInstance_Check(r)) {
  551.         static PyObject *complexstr;
  552.         PyObject *f;
  553.         if (complexstr == NULL) {
  554.             complexstr = PyString_InternFromString("__complex__");
  555.             if (complexstr == NULL)
  556.                 return NULL;
  557.         }
  558.         f = PyObject_GetAttr(r, complexstr);
  559.         if (f == NULL)
  560.             PyErr_Clear();
  561.         else {
  562.             PyObject *args = Py_BuildValue("()");
  563.             if (args == NULL)
  564.                 return NULL;
  565.             r = PyEval_CallObject(f, args);
  566.             Py_DECREF(args);
  567.             Py_DECREF(f);
  568.             if (r == NULL)
  569.                 return NULL;
  570.             own_r = 1;
  571.         }
  572.     }
  573.     if (PyComplex_Check(r)) {
  574.         cr = ((PyComplexObject*)r)->cval;
  575.         if (own_r) {
  576.             Py_DECREF(r);
  577.         }
  578.     }
  579.     else {
  580.         tmp = (*nbr->nb_float)(r);
  581.         if (own_r) {
  582.             Py_DECREF(r);
  583.         }
  584.         if (tmp == NULL)
  585.             return NULL;
  586.         cr.real = PyFloat_AsDouble(tmp);
  587.         Py_DECREF(tmp);
  588.         cr.imag = 0.0;
  589.     }
  590.     if (i == NULL) {
  591.         ci.real = 0.0;
  592.         ci.imag = 0.0;
  593.     }
  594.     else if (PyComplex_Check(i))
  595.         ci = ((PyComplexObject*)i)->cval;
  596.     else {
  597.         tmp = (*nbi->nb_float)(i);
  598.         if (tmp == NULL)
  599.             return NULL;
  600.         ci.real = PyFloat_AsDouble(tmp);
  601.         Py_DECREF(tmp);
  602.         ci.imag = 0.;
  603.     }
  604.     cr.real -= ci.imag;
  605.     cr.imag += ci.real;
  606.     return PyComplex_FromCComplex(cr);
  607. }
  608.  
  609. static char complex_doc[] =
  610. "complex(real[, imag]) -> complex number\n\
  611. \n\
  612. Create a complex number from a real part and an optional imaginary part.\n\
  613. This is equivalent to (real + imag*1j) where imag defaults to 0.";
  614.  
  615.  
  616. #endif
  617.  
  618. static PyObject *
  619. builtin_dir(self, args)
  620.     PyObject *self;
  621.     PyObject *args;
  622. {
  623.     static char *attrlist[] = {"__members__", "__methods__", NULL};
  624.     PyObject *v = NULL, *l = NULL, *m = NULL;
  625.     PyObject *d, *x;
  626.     int i;
  627.     char **s;
  628.  
  629.     if (!PyArg_ParseTuple(args, "|O:dir", &v))
  630.         return NULL;
  631.     if (v == NULL) {
  632.         x = PyEval_GetLocals();
  633.         if (x == NULL)
  634.             goto error;
  635.         l = PyMapping_Keys(x);
  636.         if (l == NULL)
  637.             goto error;
  638.     }
  639.     else {
  640.         d = PyObject_GetAttrString(v, "__dict__");
  641.         if (d == NULL)
  642.             PyErr_Clear();
  643.         else {
  644.             l = PyMapping_Keys(d);
  645.             if (l == NULL)
  646.                 PyErr_Clear();
  647.             Py_DECREF(d);
  648.         }
  649.         if (l == NULL) {
  650.             l = PyList_New(0);
  651.             if (l == NULL)
  652.                 goto error;
  653.         }
  654.         for (s = attrlist; *s != NULL; s++) {
  655.             m = PyObject_GetAttrString(v, *s);
  656.             if (m == NULL) {
  657.                 PyErr_Clear();
  658.                 continue;
  659.             }
  660.             for (i = 0; ; i++) {
  661.                 x = PySequence_GetItem(m, i);
  662.                 if (x == NULL) {
  663.                     PyErr_Clear();
  664.                     break;
  665.                 }
  666.                 if (PyList_Append(l, x) != 0) {
  667.                     Py_DECREF(x);
  668.                     Py_DECREF(m);
  669.                     goto error;
  670.                 }
  671.                 Py_DECREF(x);
  672.             }
  673.             Py_DECREF(m);
  674.         }
  675.     }
  676.     if (PyList_Sort(l) != 0)
  677.         goto error;
  678.     return l;
  679.   error:
  680.     Py_XDECREF(l);
  681.     return NULL;
  682. }
  683.  
  684. static char dir_doc[] =
  685. "dir([object]) -> list of strings\n\
  686. \n\
  687. Return an alphabetized list of names comprising (some of) the attributes\n\
  688. of the given object.  Without an argument, the names in the current scope\n\
  689. are listed.  With an instance argument, only the instance attributes are\n\
  690. returned.  With a class argument, attributes of the base class are not\n\
  691. returned.  For other types or arguments, this may list members or methods.";
  692.  
  693.  
  694. static PyObject *
  695. builtin_divmod(self, args)
  696.     PyObject *self;
  697.     PyObject *args;
  698. {
  699.     PyObject *v, *w;
  700.  
  701.     if (!PyArg_ParseTuple(args, "OO:divmod", &v, &w))
  702.         return NULL;
  703.     return PyNumber_Divmod(v, w);
  704. }
  705.  
  706. static char divmod_doc[] =
  707. "divmod(x, y) -> (div, mod)\n\
  708. \n\
  709. Return the tuple ((x-x%y)/y, x%y).  Invariant: div*y + mod == x.";
  710.  
  711.  
  712. static PyObject *
  713. builtin_eval(self, args)
  714.     PyObject *self;
  715.     PyObject *args;
  716. {
  717.     PyObject *cmd;
  718.     PyObject *globals = Py_None, *locals = Py_None;
  719.     char *str;
  720.  
  721.     if (!PyArg_ParseTuple(args, "O|O!O!:eval",
  722.             &cmd,
  723.             &PyDict_Type, &globals,
  724.             &PyDict_Type, &locals))
  725.         return NULL;
  726.     if (globals == Py_None) {
  727.         globals = PyEval_GetGlobals();
  728.         if (locals == Py_None)
  729.             locals = PyEval_GetLocals();
  730.     }
  731.     else if (locals == Py_None)
  732.         locals = globals;
  733.     if (PyDict_GetItemString(globals, "__builtins__") == NULL) {
  734.         if (PyDict_SetItemString(globals, "__builtins__",
  735.                      PyEval_GetBuiltins()) != 0)
  736.             return NULL;
  737.     }
  738.     if (PyCode_Check(cmd))
  739.         return PyEval_EvalCode((PyCodeObject *) cmd, globals, locals);
  740.     if (!PyString_Check(cmd)) {
  741.         PyErr_SetString(PyExc_TypeError,
  742.                "eval() argument 1 must be string or code object");
  743.         return NULL;
  744.     }
  745.     str = PyString_AsString(cmd);
  746.     if ((int)strlen(str) != PyString_Size(cmd)) {
  747.         PyErr_SetString(PyExc_ValueError,
  748.                "embedded '\\0' in string arg");
  749.         return NULL;
  750.     }
  751.     while (*str == ' ' || *str == '\t')
  752.         str++;
  753.     return PyRun_String(str, Py_eval_input, globals, locals);
  754. }
  755.  
  756. static char eval_doc[] =
  757. "eval(source[, globals[, locals]]) -> value\n\
  758. \n\
  759. Evaluate the source in the context of globals and locals.\n\
  760. The source may be a string representing a Python expression\n\
  761. or a code object as returned by compile().\n\
  762. The globals and locals are dictionaries, defaulting to the current\n\
  763. globals and locals.  If only globals is given, locals defaults to it.";
  764.  
  765.  
  766. static PyObject *
  767. builtin_execfile(self, args)
  768.     PyObject *self;
  769.     PyObject *args;
  770. {
  771.     char *filename;
  772.     PyObject *globals = Py_None, *locals = Py_None;
  773.     PyObject *res;
  774.     FILE* fp;
  775.  
  776.     if (!PyArg_ParseTuple(args, "s|O!O!:execfile",
  777.             &filename,
  778.             &PyDict_Type, &globals,
  779.             &PyDict_Type, &locals))
  780.         return NULL;
  781.     if (globals == Py_None) {
  782.         globals = PyEval_GetGlobals();
  783.         if (locals == Py_None)
  784.             locals = PyEval_GetLocals();
  785.     }
  786.     else if (locals == Py_None)
  787.         locals = globals;
  788.     if (PyDict_GetItemString(globals, "__builtins__") == NULL) {
  789.         if (PyDict_SetItemString(globals, "__builtins__",
  790.                      PyEval_GetBuiltins()) != 0)
  791.             return NULL;
  792.     }
  793.     Py_BEGIN_ALLOW_THREADS
  794.     fp = fopen(filename, "r");
  795.     Py_END_ALLOW_THREADS
  796.     if (fp == NULL) {
  797.         PyErr_SetFromErrno(PyExc_IOError);
  798.         return NULL;
  799.     }
  800.     res = PyRun_File(fp, filename, Py_file_input, globals, locals);
  801.     Py_BEGIN_ALLOW_THREADS
  802.     fclose(fp);
  803.     Py_END_ALLOW_THREADS
  804.     return res;
  805. }
  806.  
  807. static char execfile_doc[] =
  808. "execfile(filename[, globals[, locals]])\n\
  809. \n\
  810. Read and execute a Python script from a file.\n\
  811. The globals and locals are dictionaries, defaulting to the current\n\
  812. globals and locals.  If only globals is given, locals defaults to it.";
  813.  
  814.  
  815. static PyObject *
  816. builtin_float(self, args)
  817.     PyObject *self;
  818.     PyObject *args;
  819. {
  820.     PyObject *v;
  821.  
  822.     if (!PyArg_ParseTuple(args, "O:float", &v))
  823.         return NULL;
  824.     return PyNumber_Float(v);
  825. }
  826.  
  827. static char float_doc[] =
  828. "float(x) -> floating point number\n\
  829. \n\
  830. Convert a string or number to a floating point number, if possible.";
  831.  
  832.  
  833. static PyObject *
  834. builtin_getattr(self, args)
  835.     PyObject *self;
  836.     PyObject *args;
  837. {
  838.     PyObject *v, *result, *dflt = NULL;
  839.     PyObject *name;
  840.  
  841.     if (!PyArg_ParseTuple(args, "OS|O:getattr", &v, &name, &dflt))
  842.         return NULL;
  843.     result = PyObject_GetAttr(v, name);
  844.     if (result == NULL && dflt != NULL) {
  845.         PyErr_Clear();
  846.         Py_INCREF(dflt);
  847.         result = dflt;
  848.     }
  849.     return result;
  850. }
  851.  
  852. static char getattr_doc[] =
  853. "getattr(object, name[, default]) -> value\n\
  854. \n\
  855. Get a named attribute from an object; getattr(x, 'y') is equivalent to x.y.\n\
  856. When a default argument is given, it is returned when the attribute doesn't\n\
  857. exist; without it, an exception is raised in that case.";
  858.  
  859.  
  860. static PyObject *
  861. builtin_globals(self, args)
  862.     PyObject *self;
  863.     PyObject *args;
  864. {
  865.     PyObject *d;
  866.  
  867.     if (!PyArg_ParseTuple(args, ""))
  868.         return NULL;
  869.     d = PyEval_GetGlobals();
  870.     Py_INCREF(d);
  871.     return d;
  872. }
  873.  
  874. static char globals_doc[] =
  875. "globals() -> dictionary\n\
  876. \n\
  877. Return the dictionary containing the current scope's global variables.";
  878.  
  879.  
  880. static PyObject *
  881. builtin_hasattr(self, args)
  882.     PyObject *self;
  883.     PyObject *args;
  884. {
  885.     PyObject *v;
  886.     PyObject *name;
  887.  
  888.     if (!PyArg_ParseTuple(args, "OS:hasattr", &v, &name))
  889.         return NULL;
  890.     v = PyObject_GetAttr(v, name);
  891.     if (v == NULL) {
  892.         PyErr_Clear();
  893.         Py_INCREF(Py_False);
  894.         return Py_False;
  895.     }
  896.     Py_DECREF(v);
  897.     Py_INCREF(Py_True);
  898.     return Py_True;
  899. }
  900.  
  901. static char hasattr_doc[] =
  902. "hasattr(object, name) -> Boolean\n\
  903. \n\
  904. Return whether the object has an attribute with the given name.\n\
  905. (This is done by calling getattr(object, name) and catching exceptions.)";
  906.  
  907.  
  908. static PyObject *
  909. builtin_id(self, args)
  910.     PyObject *self;
  911.     PyObject *args;
  912. {
  913.     PyObject *v;
  914.  
  915.     if (!PyArg_ParseTuple(args, "O:id", &v))
  916.         return NULL;
  917.     return PyInt_FromLong((long)v);
  918. }
  919.  
  920. static char id_doc[] =
  921. "id(object) -> integer\n\
  922. \n\
  923. Return the identity of an object.  This is guaranteed to be unique among\n\
  924. simultaneously existing objects.  (Hint: it's the object's memory address.)";
  925.  
  926.  
  927. static PyObject *
  928. builtin_map(self, args)
  929.     PyObject *self;
  930.     PyObject *args;
  931. {
  932.     typedef struct {
  933.         PyObject *seq;
  934.         PySequenceMethods *sqf;
  935.         int len;
  936.     } sequence;
  937.  
  938.     PyObject *func, *result;
  939.     sequence *seqs = NULL, *sqp;
  940.     int n, len;
  941.     register int i, j;
  942.  
  943.     n = PyTuple_Size(args);
  944.     if (n < 2) {
  945.         PyErr_SetString(PyExc_TypeError,
  946.                 "map() requires at least two args");
  947.         return NULL;
  948.     }
  949.  
  950.     func = PyTuple_GetItem(args, 0);
  951.     n--;
  952.  
  953.     if (func == Py_None && n == 1) {
  954.         /* map(None, S) is the same as list(S). */
  955.         return PySequence_List(PyTuple_GetItem(args, 1));
  956.     }
  957.  
  958.     if ((seqs = PyMem_NEW(sequence, n)) == NULL) {
  959.         PyErr_NoMemory();
  960.         goto Fail_2;
  961.     }
  962.  
  963.     for (len = 0, i = 0, sqp = seqs; i < n; ++i, ++sqp) {
  964.         int curlen;
  965.         PySequenceMethods *sqf;
  966.     
  967.         if ((sqp->seq = PyTuple_GetItem(args, i + 1)) == NULL)
  968.             goto Fail_2;
  969.  
  970.         sqp->sqf = sqf = sqp->seq->ob_type->tp_as_sequence;
  971.         if (sqf == NULL ||
  972.             sqf->sq_length == NULL ||
  973.             sqf->sq_item == NULL)
  974.         {
  975.             static char errmsg[] =
  976.                 "argument %d to map() must be a sequence object";
  977.             char errbuf[sizeof(errmsg) + 25];
  978.  
  979.             sprintf(errbuf, errmsg, i+2);
  980.             PyErr_SetString(PyExc_TypeError, errbuf);
  981.             goto Fail_2;
  982.         }
  983.  
  984.         if ((curlen = sqp->len = (*sqp->sqf->sq_length)(sqp->seq)) < 0)
  985.             goto Fail_2;
  986.  
  987.         if (curlen > len)
  988.             len = curlen;
  989.     }
  990.  
  991.     if ((result = (PyObject *) PyList_New(len)) == NULL)
  992.         goto Fail_2;
  993.  
  994.     for (i = 0; ; ++i) {
  995.         PyObject *alist, *item=NULL, *value;
  996.         int any = 0;
  997.  
  998.         if (func == Py_None && n == 1)
  999.             alist = NULL;
  1000.         else {
  1001.             if ((alist = PyTuple_New(n)) == NULL)
  1002.                 goto Fail_1;
  1003.         }
  1004.  
  1005.         for (j = 0, sqp = seqs; j < n; ++j, ++sqp) {
  1006.             if (sqp->len < 0) {
  1007.                 Py_INCREF(Py_None);
  1008.                 item = Py_None;
  1009.             }
  1010.             else {
  1011.                 item = (*sqp->sqf->sq_item)(sqp->seq, i);
  1012.                 if (item == NULL) {
  1013.                     if (PyErr_ExceptionMatches(
  1014.                         PyExc_IndexError))
  1015.                     {
  1016.                         PyErr_Clear();
  1017.                         Py_INCREF(Py_None);
  1018.                         item = Py_None;
  1019.                         sqp->len = -1;
  1020.                     }
  1021.                     else {
  1022.                         goto Fail_0;
  1023.                     }
  1024.                 }
  1025.                 else
  1026.                     any = 1;
  1027.  
  1028.             }
  1029.             if (!alist)
  1030.                 break;
  1031.             if (PyTuple_SetItem(alist, j, item) < 0) {
  1032.                 Py_DECREF(item);
  1033.                 goto Fail_0;
  1034.             }
  1035.             continue;
  1036.  
  1037.         Fail_0:
  1038.             Py_XDECREF(alist);
  1039.             goto Fail_1;
  1040.         }
  1041.  
  1042.         if (!alist)
  1043.             alist = item;
  1044.  
  1045.         if (!any) {
  1046.             Py_DECREF(alist);
  1047.             break;
  1048.         }
  1049.  
  1050.         if (func == Py_None)
  1051.             value = alist;
  1052.         else {
  1053.             value = PyEval_CallObject(func, alist);
  1054.             Py_DECREF(alist);
  1055.             if (value == NULL)
  1056.                 goto Fail_1;
  1057.         }
  1058.         if (i >= len) {
  1059.             int status = PyList_Append(result, value);
  1060.             Py_DECREF(value);
  1061.             if (status < 0)
  1062.                 goto Fail_1;
  1063.         }
  1064.         else {
  1065.             if (PyList_SetItem(result, i, value) < 0)
  1066.                 goto Fail_1;
  1067.         }
  1068.     }
  1069.  
  1070.     if (i < len && PyList_SetSlice(result, i, len, NULL) < 0)
  1071.         goto Fail_1;
  1072.  
  1073.     PyMem_DEL(seqs);
  1074.     return result;
  1075.  
  1076. Fail_1:
  1077.     Py_DECREF(result);
  1078. Fail_2:
  1079.     if (seqs) PyMem_DEL(seqs);
  1080.     return NULL;
  1081. }
  1082.  
  1083. static char map_doc[] =
  1084. "map(function, sequence[, sequence, ...]) -> list\n\
  1085. \n\
  1086. Return a list of the results of applying the function to the items of\n\
  1087. the argument sequence(s).  If more than one sequence is given, the\n\
  1088. function is called with an argument list consisting of the corresponding\n\
  1089. item of each sequence, substituting None for missing values when not all\n\
  1090. sequences have the same length.  If the function is None, return a list of\n\
  1091. the items of the sequence (or a list of tuples if more than one sequence).";
  1092.  
  1093.  
  1094. static PyObject *
  1095. builtin_setattr(self, args)
  1096.     PyObject *self;
  1097.     PyObject *args;
  1098. {
  1099.     PyObject *v;
  1100.     PyObject *name;
  1101.     PyObject *value;
  1102.  
  1103.     if (!PyArg_ParseTuple(args, "OSO:setattr", &v, &name, &value))
  1104.         return NULL;
  1105.     if (PyObject_SetAttr(v, name, value) != 0)
  1106.         return NULL;
  1107.     Py_INCREF(Py_None);
  1108.     return Py_None;
  1109. }
  1110.  
  1111. static char setattr_doc[] =
  1112. "setattr(object, name, value)\n\
  1113. \n\
  1114. Set a named attribute on an object; setattr(x, 'y', v) is equivalent to\n\
  1115. ``x.y = v''.";
  1116.  
  1117.  
  1118. static PyObject *
  1119. builtin_delattr(self, args)
  1120.     PyObject *self;
  1121.     PyObject *args;
  1122. {
  1123.     PyObject *v;
  1124.     PyObject *name;
  1125.  
  1126.     if (!PyArg_ParseTuple(args, "OS:delattr", &v, &name))
  1127.         return NULL;
  1128.     if (PyObject_SetAttr(v, name, (PyObject *)NULL) != 0)
  1129.         return NULL;
  1130.     Py_INCREF(Py_None);
  1131.     return Py_None;
  1132. }
  1133.  
  1134. static char delattr_doc[] =
  1135. "delattr(object, name)\n\
  1136. \n\
  1137. Delete a named attribute on an object; delattr(x, 'y') is equivalent to\n\
  1138. ``del x.y''.";
  1139.  
  1140.  
  1141. static PyObject *
  1142. builtin_hash(self, args)
  1143.     PyObject *self;
  1144.     PyObject *args;
  1145. {
  1146.     PyObject *v;
  1147.     long x;
  1148.  
  1149.     if (!PyArg_ParseTuple(args, "O:hash", &v))
  1150.         return NULL;
  1151.     x = PyObject_Hash(v);
  1152.     if (x == -1)
  1153.         return NULL;
  1154.     return PyInt_FromLong(x);
  1155. }
  1156.  
  1157. static char hash_doc[] =
  1158. "hash(object) -> integer\n\
  1159. \n\
  1160. Return a hash value for the object.  Two objects with the same value have\n\
  1161. the same hash value.  The reverse is not necessarily true, but likely.";
  1162.  
  1163.  
  1164. static PyObject *
  1165. builtin_hex(self, args)
  1166.     PyObject *self;
  1167.     PyObject *args;
  1168. {
  1169.     PyObject *v;
  1170.     PyNumberMethods *nb;
  1171.  
  1172.     if (!PyArg_ParseTuple(args, "O:hex", &v))
  1173.         return NULL;
  1174.     
  1175.     if ((nb = v->ob_type->tp_as_number) == NULL ||
  1176.         nb->nb_hex == NULL) {
  1177.         PyErr_SetString(PyExc_TypeError,
  1178.                "hex() argument can't be converted to hex");
  1179.         return NULL;
  1180.     }
  1181.     return (*nb->nb_hex)(v);
  1182. }
  1183.  
  1184. static char hex_doc[] =
  1185. "hex(number) -> string\n\
  1186. \n\
  1187. Return the hexadecimal representation of an integer or long integer.";
  1188.  
  1189.  
  1190. static PyObject *builtin_raw_input Py_PROTO((PyObject *, PyObject *));
  1191.  
  1192. static PyObject *
  1193. builtin_input(self, args)
  1194.     PyObject *self;
  1195.     PyObject *args;
  1196. {
  1197.     PyObject *line;
  1198.     char *str;
  1199.     PyObject *res;
  1200.     PyObject *globals, *locals;
  1201.  
  1202.     line = builtin_raw_input(self, args);
  1203.     if (line == NULL)
  1204.         return line;
  1205.     if (!PyArg_Parse(line, "s;embedded '\\0' in input line", &str))
  1206.         return NULL;
  1207.     while (*str == ' ' || *str == '\t')
  1208.             str++;
  1209.     globals = PyEval_GetGlobals();
  1210.     locals = PyEval_GetLocals();
  1211.     if (PyDict_GetItemString(globals, "__builtins__") == NULL) {
  1212.         if (PyDict_SetItemString(globals, "__builtins__",
  1213.                      PyEval_GetBuiltins()) != 0)
  1214.             return NULL;
  1215.     }
  1216.     res = PyRun_String(str, Py_eval_input, globals, locals);
  1217.     Py_DECREF(line);
  1218.     return res;
  1219. }
  1220.  
  1221. static char input_doc[] =
  1222. "input([prompt]) -> value\n\
  1223. \n\
  1224. Equivalent to eval(raw_input(prompt)).";
  1225.  
  1226.  
  1227. static PyObject *
  1228. builtin_intern(self, args)
  1229.     PyObject *self;
  1230.     PyObject *args;
  1231. {
  1232.     PyObject *s;
  1233.     if (!PyArg_ParseTuple(args, "S", &s))
  1234.         return NULL;
  1235.     Py_INCREF(s);
  1236.     PyString_InternInPlace(&s);
  1237.     return s;
  1238. }
  1239.  
  1240. static char intern_doc[] =
  1241. "intern(string) -> string\n\
  1242. \n\
  1243. ``Intern'' the given string.  This enters the string in the (global)\n\
  1244. table of interned strings whose purpose is to speed up dictionary lookups.\n\
  1245. Return the string itself or the previously interned string object with the\n\
  1246. same value.";
  1247.  
  1248.  
  1249. static PyObject *
  1250. builtin_int(self, args)
  1251.     PyObject *self;
  1252.     PyObject *args;
  1253. {
  1254.     PyObject *v;
  1255.  
  1256.     if (!PyArg_ParseTuple(args, "O:int", &v))
  1257.         return NULL;
  1258.     return PyNumber_Int(v);
  1259. }
  1260.  
  1261. static char int_doc[] =
  1262. "int(x) -> integer\n\
  1263. \n\
  1264. Convert a string or number to an integer, if possible.\n\
  1265. A floating point argument will be truncated towards zero.";
  1266.  
  1267.  
  1268. static PyObject *
  1269. builtin_len(self, args)
  1270.     PyObject *self;
  1271.     PyObject *args;
  1272. {
  1273.     PyObject *v;
  1274.     long res;
  1275.  
  1276.     if (!PyArg_ParseTuple(args, "O:len", &v))
  1277.         return NULL;
  1278.     res = PyObject_Length(v);
  1279.     if (res < 0 && PyErr_Occurred())
  1280.         return NULL;
  1281.     return PyInt_FromLong(res);
  1282. }
  1283.  
  1284. static char len_doc[] =
  1285. "len(object) -> integer\n\
  1286. \n\
  1287. Return the number of items of a sequence or mapping.";
  1288.  
  1289.  
  1290. static PyObject *
  1291. builtin_list(self, args)
  1292.     PyObject *self;
  1293.     PyObject *args;
  1294. {
  1295.     PyObject *v;
  1296.  
  1297.     if (!PyArg_ParseTuple(args, "O:list", &v))
  1298.         return NULL;
  1299.     return PySequence_List(v);
  1300. }
  1301.  
  1302. static char list_doc[] =
  1303. "list(sequence) -> list\n\
  1304. \n\
  1305. Return a new list whose items are the same as those of the argument sequence.";
  1306.  
  1307.  
  1308. static PyObject *
  1309. builtin_slice(self, args)
  1310.      PyObject *self;
  1311.      PyObject *args;
  1312. {
  1313.     PyObject *start, *stop, *step;
  1314.  
  1315.     start = stop = step = NULL;
  1316.  
  1317.     if (!PyArg_ParseTuple(args, "O|OO:slice", &start, &stop, &step))
  1318.         return NULL;
  1319.  
  1320.     /* This swapping of stop and start is to maintain similarity with
  1321.        range(). */
  1322.     if (stop == NULL) {
  1323.         stop = start;
  1324.         start = NULL;
  1325.     }
  1326.     return PySlice_New(start, stop, step);
  1327. }
  1328.  
  1329. static char slice_doc[] =
  1330. "slice([start,] step[, stop]) -> slice object\n\
  1331. \n\
  1332. Create a slice object.  This is used for slicing by the Numeric extensions.";
  1333.  
  1334.  
  1335. static PyObject *
  1336. builtin_locals(self, args)
  1337.     PyObject *self;
  1338.     PyObject *args;
  1339. {
  1340.     PyObject *d;
  1341.  
  1342.     if (!PyArg_ParseTuple(args, ""))
  1343.         return NULL;
  1344.     d = PyEval_GetLocals();
  1345.     Py_INCREF(d);
  1346.     return d;
  1347. }
  1348.  
  1349. static char locals_doc[] =
  1350. "locals() -> dictionary\n\
  1351. \n\
  1352. Return the dictionary containing the current scope's local variables.";
  1353.  
  1354.  
  1355. static PyObject *
  1356. builtin_long(self, args)
  1357.     PyObject *self;
  1358.     PyObject *args;
  1359. {
  1360.     PyObject *v;
  1361.     
  1362.     if (!PyArg_ParseTuple(args, "O:long", &v))
  1363.         return NULL;
  1364.     return PyNumber_Long(v);
  1365. }
  1366.  
  1367. static char long_doc[] =
  1368. "long(x) -> long integer\n\
  1369. \n\
  1370. Convert a string or number to a long integer, if possible.\n\
  1371. A floating point argument will be truncated towards zero.";
  1372.  
  1373.  
  1374. static PyObject *
  1375. min_max(args, sign)
  1376.     PyObject *args;
  1377.     int sign;
  1378. {
  1379.     int i;
  1380.     PyObject *v, *w, *x;
  1381.     PySequenceMethods *sq;
  1382.  
  1383.     if (PyTuple_Size(args) > 1)
  1384.         v = args;
  1385.     else if (!PyArg_ParseTuple(args, "O:min/max", &v))
  1386.         return NULL;
  1387.     sq = v->ob_type->tp_as_sequence;
  1388.     if (sq == NULL || sq->sq_item == NULL) {
  1389.         PyErr_SetString(PyExc_TypeError,
  1390.                 "min() or max() of non-sequence");
  1391.         return NULL;
  1392.     }
  1393.     w = NULL;
  1394.     for (i = 0; ; i++) {
  1395.         x = (*sq->sq_item)(v, i); /* Implies INCREF */
  1396.         if (x == NULL) {
  1397.             if (PyErr_ExceptionMatches(PyExc_IndexError)) {
  1398.                 PyErr_Clear();
  1399.                 break;
  1400.             }
  1401.             Py_XDECREF(w);
  1402.             return NULL;
  1403.         }
  1404.         if (w == NULL)
  1405.             w = x;
  1406.         else {
  1407.             int c = PyObject_Compare(x, w);
  1408.             if (c && PyErr_Occurred()) {
  1409.                 Py_DECREF(x);
  1410.                 Py_XDECREF(w);
  1411.                 return NULL;
  1412.             }
  1413.             if (c * sign > 0) {
  1414.                 Py_DECREF(w);
  1415.                 w = x;
  1416.             }
  1417.             else
  1418.                 Py_DECREF(x);
  1419.         }
  1420.     }
  1421.     if (w == NULL)
  1422.         PyErr_SetString(PyExc_ValueError,
  1423.                 "min() or max() of empty sequence");
  1424.     return w;
  1425. }
  1426.  
  1427. static PyObject *
  1428. builtin_min(self, v)
  1429.     PyObject *self;
  1430.     PyObject *v;
  1431. {
  1432.     return min_max(v, -1);
  1433. }
  1434.  
  1435. static char min_doc[] =
  1436. "min(sequence) -> value\n\
  1437. min(a, b, c, ...) -> value\n\
  1438. \n\
  1439. With a single sequence argument, return its smallest item.\n\
  1440. With two or more arguments, return the smallest argument.";
  1441.  
  1442.  
  1443. static PyObject *
  1444. builtin_max(self, v)
  1445.     PyObject *self;
  1446.     PyObject *v;
  1447. {
  1448.     return min_max(v, 1);
  1449. }
  1450.  
  1451. static char max_doc[] =
  1452. "max(sequence) -> value\n\
  1453. max(a, b, c, ...) -> value\n\
  1454. \n\
  1455. With a single sequence argument, return its largest item.\n\
  1456. With two or more arguments, return the largest argument.";
  1457.  
  1458.  
  1459. static PyObject *
  1460. builtin_oct(self, args)
  1461.     PyObject *self;
  1462.     PyObject *args;
  1463. {
  1464.     PyObject *v;
  1465.     PyNumberMethods *nb;
  1466.  
  1467.     if (!PyArg_ParseTuple(args, "O:oct", &v))
  1468.         return NULL;
  1469.     if (v == NULL || (nb = v->ob_type->tp_as_number) == NULL ||
  1470.         nb->nb_oct == NULL) {
  1471.         PyErr_SetString(PyExc_TypeError,
  1472.                "oct() argument can't be converted to oct");
  1473.         return NULL;
  1474.     }
  1475.     return (*nb->nb_oct)(v);
  1476. }
  1477.  
  1478. static char oct_doc[] =
  1479. "oct(number) -> string\n\
  1480. \n\
  1481. Return the octal representation of an integer or long integer.";
  1482.  
  1483.  
  1484. static PyObject *
  1485. builtin_open(self, args)
  1486.     PyObject *self;
  1487.     PyObject *args;
  1488. {
  1489.     char *name;
  1490.     char *mode = "r";
  1491.     int bufsize = -1;
  1492.     PyObject *f;
  1493.  
  1494.     if (!PyArg_ParseTuple(args, "s|si:open", &name, &mode, &bufsize))
  1495.         return NULL;
  1496.     f = PyFile_FromString(name, mode);
  1497.     if (f != NULL)
  1498.         PyFile_SetBufSize(f, bufsize);
  1499.     return f;
  1500. }
  1501.  
  1502. static char open_doc[] =
  1503. "open(filename[, mode[, buffering]]) -> file object\n\
  1504. \n\
  1505. Open a file.  The mode can be 'r', 'w' or 'a' for reading (default),\n\
  1506. writing or appending.  The file will be created if it doesn't exist\n\
  1507. when opened for writing or appending; it will be truncated when\n\
  1508. opened for writing.  Add a 'b' to the mode for binary files.\n\
  1509. Add a '+' to the mode to allow simultaneous reading and writing.\n\
  1510. If the buffering argument is given, 0 means unbuffered, 1 means line\n\
  1511. buffered, and larger numbers specify the buffer size.";
  1512.  
  1513.  
  1514. static PyObject *
  1515. builtin_ord(self, args)
  1516.     PyObject *self;
  1517.     PyObject *args;
  1518. {
  1519.     char c;
  1520.  
  1521.     if (!PyArg_ParseTuple(args, "c:ord", &c))
  1522.         return NULL;
  1523.     return PyInt_FromLong((long)(c & 0xff));
  1524. }
  1525.  
  1526. static char ord_doc[] =
  1527. "ord(c) -> integer\n\
  1528. \n\
  1529. Return the integer ordinal of a one character string.";
  1530.  
  1531.  
  1532. static PyObject *
  1533. builtin_pow(self, args)
  1534.     PyObject *self;
  1535.     PyObject *args;
  1536. {
  1537.     PyObject *v, *w, *z = Py_None;
  1538.  
  1539.     if (!PyArg_ParseTuple(args, "OO|O:pow", &v, &w, &z))
  1540.         return NULL;
  1541.     return PyNumber_Power(v, w, z);
  1542. }
  1543.  
  1544. static char pow_doc[] =
  1545. "pow(x, y[, z]) -> number\n\
  1546. \n\
  1547. With two arguments, equivalent to x**y.  With three arguments,\n\
  1548. equivalent to (x**y) % z, but may be more efficient (e.g. for longs).";
  1549.  
  1550.  
  1551. /* Return number of items in range/xrange (lo, hi, step).  step > 0
  1552.  * required.  Return a value < 0 if & only if the true value is too
  1553.  * large to fit in a signed long.
  1554.  */
  1555. static long
  1556. get_len_of_range(lo, hi, step)
  1557.     long lo;
  1558.     long hi;
  1559.     long step;    /* must be > 0 */
  1560. {
  1561.     /* -------------------------------------------------------------
  1562.     If lo >= hi, the range is empty.
  1563.     Else if n values are in the range, the last one is
  1564.     lo + (n-1)*step, which must be <= hi-1.  Rearranging,
  1565.     n <= (hi - lo - 1)/step + 1, so taking the floor of the RHS gives
  1566.     the proper value.  Since lo < hi in this case, hi-lo-1 >= 0, so
  1567.     the RHS is non-negative and so truncation is the same as the
  1568.     floor.  Letting M be the largest positive long, the worst case
  1569.     for the RHS numerator is hi=M, lo=-M-1, and then
  1570.     hi-lo-1 = M-(-M-1)-1 = 2*M.  Therefore unsigned long has enough
  1571.     precision to compute the RHS exactly.
  1572.     ---------------------------------------------------------------*/
  1573.     long n = 0;
  1574.     if (lo < hi) {
  1575.         unsigned long uhi = (unsigned long)hi;
  1576.         unsigned long ulo = (unsigned long)lo;
  1577.         unsigned long diff = uhi - ulo - 1;
  1578.         n = (long)(diff / (unsigned long)step + 1);
  1579.     }
  1580.     return n;
  1581. }
  1582.  
  1583. static PyObject *
  1584. builtin_range(self, args)
  1585.     PyObject *self;
  1586.     PyObject *args;
  1587. {
  1588.     long ilow = 0, ihigh = 0, istep = 1;
  1589.     long bign;
  1590.     int i, n;
  1591.  
  1592.     PyObject *v;
  1593.  
  1594.     if (PyTuple_Size(args) <= 1) {
  1595.         if (!PyArg_ParseTuple(args,
  1596.                 "l;range() requires 1-3 int arguments",
  1597.                 &ihigh))
  1598.             return NULL;
  1599.     }
  1600.     else {
  1601.         if (!PyArg_ParseTuple(args,
  1602.                 "ll|l;range() requires 1-3 int arguments",
  1603.                 &ilow, &ihigh, &istep))
  1604.             return NULL;
  1605.     }
  1606.     if (istep == 0) {
  1607.         PyErr_SetString(PyExc_ValueError, "zero step for range()");
  1608.         return NULL;
  1609.     }
  1610.     if (istep > 0)
  1611.         bign = get_len_of_range(ilow, ihigh, istep);
  1612.     else
  1613.         bign = get_len_of_range(ihigh, ilow, -istep);
  1614.     n = (int)bign;
  1615.     if (bign < 0 || (long)n != bign) {
  1616.         PyErr_SetString(PyExc_OverflowError,
  1617.                 "range() has too many items");
  1618.         return NULL;
  1619.     }
  1620.     v = PyList_New(n);
  1621.     if (v == NULL)
  1622.         return NULL;
  1623.     for (i = 0; i < n; i++) {
  1624.         PyObject *w = PyInt_FromLong(ilow);
  1625.         if (w == NULL) {
  1626.             Py_DECREF(v);
  1627.             return NULL;
  1628.         }
  1629.         PyList_SET_ITEM(v, i, w);
  1630.         ilow += istep;
  1631.     }
  1632.     return v;
  1633. }
  1634.  
  1635. static char range_doc[] =
  1636. "range([start,] stop[, step]) -> list of integers\n\
  1637. \n\
  1638. Return a list containing an arithmetic progression of integers.\n\
  1639. range(i, j) returns [i, i+1, i+2, ..., j-1]; start (!) defaults to 0.\n\
  1640. When step is given, it specifies the increment (or decrement).\n\
  1641. For example, range(4) returns [0, 1, 2, 3].  The end point is omitted!\n\
  1642. These are exactly the valid indices for a list of 4 elements.";
  1643.  
  1644.  
  1645. static PyObject *
  1646. builtin_xrange(self, args)
  1647.     PyObject *self;
  1648.     PyObject *args;
  1649. {
  1650.     long ilow = 0, ihigh = 0, istep = 1;
  1651.     long n;
  1652.  
  1653.     if (PyTuple_Size(args) <= 1) {
  1654.         if (!PyArg_ParseTuple(args,
  1655.                 "l;xrange() requires 1-3 int arguments",
  1656.                 &ihigh))
  1657.             return NULL;
  1658.     }
  1659.     else {
  1660.         if (!PyArg_ParseTuple(args,
  1661.                 "ll|l;xrange() requires 1-3 int arguments",
  1662.                 &ilow, &ihigh, &istep))
  1663.             return NULL;
  1664.     }
  1665.     if (istep == 0) {
  1666.         PyErr_SetString(PyExc_ValueError, "zero step for xrange()");
  1667.         return NULL;
  1668.     }
  1669.     if (istep > 0)
  1670.         n = get_len_of_range(ilow, ihigh, istep);
  1671.     else
  1672.         n = get_len_of_range(ihigh, ilow, -istep);
  1673.     if (n < 0) {
  1674.         PyErr_SetString(PyExc_OverflowError,
  1675.                 "xrange() has more than sys.maxint items");
  1676.         return NULL;
  1677.     }
  1678.     return PyRange_New(ilow, n, istep, 1);
  1679. }
  1680.  
  1681. static char xrange_doc[] =
  1682. "xrange([start,] stop[, step]) -> xrange object\n\
  1683. \n\
  1684. Like range(), but instead of returning a list, returns an object that\n\
  1685. generates the numbers in the range on demand.  This is slightly slower\n\
  1686. than range() but more memory efficient.";
  1687.  
  1688.  
  1689. static PyObject *
  1690. builtin_raw_input(self, args)
  1691.     PyObject *self;
  1692.     PyObject *args;
  1693. {
  1694.     PyObject *v = NULL;
  1695.     PyObject *f;
  1696.  
  1697.     if (!PyArg_ParseTuple(args, "|O:[raw_]input", &v))
  1698.         return NULL;
  1699.     if (PyFile_AsFile(PySys_GetObject("stdin")) == stdin &&
  1700.         PyFile_AsFile(PySys_GetObject("stdout")) == stdout &&
  1701.         isatty(fileno(stdin)) && isatty(fileno(stdout))) {
  1702.         PyObject *po;
  1703.         char *prompt;
  1704.         char *s;
  1705.         PyObject *result;
  1706.         if (v != NULL) {
  1707.             po = PyObject_Str(v);
  1708.             if (po == NULL)
  1709.                 return NULL;
  1710.             prompt = PyString_AsString(po);
  1711.             if (prompt == NULL)
  1712.                 return NULL;
  1713.         }
  1714.         else {
  1715.             po = NULL;
  1716.             prompt = "";
  1717.         }
  1718.         s = PyOS_Readline(prompt);
  1719.         Py_XDECREF(po);
  1720.         if (s == NULL) {
  1721.             PyErr_SetNone(PyExc_KeyboardInterrupt);
  1722.             return NULL;
  1723.         }
  1724.         if (*s == '\0') {
  1725.             PyErr_SetNone(PyExc_EOFError);
  1726.             result = NULL;
  1727.         }
  1728.         else { /* strip trailing '\n' */
  1729.             result = PyString_FromStringAndSize(s, strlen(s)-1);
  1730.         }
  1731.         free(s);
  1732.         return result;
  1733.     }
  1734.     if (v != NULL) {
  1735.         f = PySys_GetObject("stdout");
  1736.         if (f == NULL) {
  1737.             PyErr_SetString(PyExc_RuntimeError, "lost sys.stdout");
  1738.             return NULL;
  1739.         }
  1740.         if (Py_FlushLine() != 0 ||
  1741.             PyFile_WriteObject(v, f, Py_PRINT_RAW) != 0)
  1742.             return NULL;
  1743.     }
  1744.     f = PySys_GetObject("stdin");
  1745.     if (f == NULL) {
  1746.         PyErr_SetString(PyExc_RuntimeError, "lost sys.stdin");
  1747.         return NULL;
  1748.     }
  1749.     return PyFile_GetLine(f, -1);
  1750. }
  1751.  
  1752. static char raw_input_doc[] =
  1753. "raw_input([prompt]) -> string\n\
  1754. \n\
  1755. Read a string from standard input.  The trailing newline is stripped.\n\
  1756. If the user hits EOF (Unix: Ctl-D, Windows: Ctl-Z+Return), raise EOFError.\n\
  1757. On Unix, GNU readline is used if enabled.  The prompt string, if given,\n\
  1758. is printed without a trailing newline before reading.";
  1759.  
  1760.  
  1761. static PyObject *
  1762. builtin_reduce(self, args)
  1763.     PyObject *self;
  1764.     PyObject *args;
  1765. {
  1766.     PyObject *seq, *func, *result = NULL;
  1767.     PySequenceMethods *sqf;
  1768.     register int i;
  1769.  
  1770.     if (!PyArg_ParseTuple(args, "OO|O:reduce", &func, &seq, &result))
  1771.         return NULL;
  1772.     if (result != NULL)
  1773.         Py_INCREF(result);
  1774.  
  1775.     sqf = seq->ob_type->tp_as_sequence;
  1776.     if (sqf == NULL || sqf->sq_item == NULL) {
  1777.         PyErr_SetString(PyExc_TypeError,
  1778.             "2nd argument to reduce() must be a sequence object");
  1779.         return NULL;
  1780.     }
  1781.  
  1782.     if ((args = PyTuple_New(2)) == NULL)
  1783.         goto Fail;
  1784.  
  1785.     for (i = 0; ; ++i) {
  1786.         PyObject *op2;
  1787.  
  1788.         if (args->ob_refcnt > 1) {
  1789.             Py_DECREF(args);
  1790.             if ((args = PyTuple_New(2)) == NULL)
  1791.                 goto Fail;
  1792.         }
  1793.  
  1794.         if ((op2 = (*sqf->sq_item)(seq, i)) == NULL) {
  1795.             if (PyErr_ExceptionMatches(PyExc_IndexError)) {
  1796.                 PyErr_Clear();
  1797.                 break;
  1798.             }
  1799.             goto Fail;
  1800.         }
  1801.  
  1802.         if (result == NULL)
  1803.             result = op2;
  1804.         else {
  1805.             PyTuple_SetItem(args, 0, result);
  1806.             PyTuple_SetItem(args, 1, op2);
  1807.             if ((result = PyEval_CallObject(func, args)) == NULL)
  1808.                 goto Fail;
  1809.         }
  1810.     }
  1811.  
  1812.     Py_DECREF(args);
  1813.  
  1814.     if (result == NULL)
  1815.         PyErr_SetString(PyExc_TypeError,
  1816.                "reduce of empty sequence with no initial value");
  1817.  
  1818.     return result;
  1819.  
  1820. Fail:
  1821.     Py_XDECREF(args);
  1822.     Py_XDECREF(result);
  1823.     return NULL;
  1824. }
  1825.  
  1826. static char reduce_doc[] =
  1827. "reduce(function, sequence[, initial]) -> value\n\
  1828. \n\
  1829. Apply a function of two arguments cumulatively to the items of a sequence,\n\
  1830. from left to right, so as to reduce the sequence to a single value.\n\
  1831. For example, reduce(lambda x, y: x+y, [1, 2, 3, 4, 5]) calculates\n\
  1832. ((((1+2)+3)+4)+5).  If initial is present, it is placed before the items\n\
  1833. of the sequence in the calculation, and serves as a default when the\n\
  1834. sequence is empty.";
  1835.  
  1836.  
  1837. static PyObject *
  1838. builtin_reload(self, args)
  1839.     PyObject *self;
  1840.     PyObject *args;
  1841. {
  1842.     PyObject *v;
  1843.  
  1844.     if (!PyArg_ParseTuple(args, "O:reload", &v))
  1845.         return NULL;
  1846.     return PyImport_ReloadModule(v);
  1847. }
  1848.  
  1849. static char reload_doc[] =
  1850. "reload(module) -> module\n\
  1851. \n\
  1852. Reload the module.  The module must have been successfully imported before.";
  1853.  
  1854.  
  1855. static PyObject *
  1856. builtin_repr(self, args)
  1857.     PyObject *self;
  1858.     PyObject *args;
  1859. {
  1860.     PyObject *v;
  1861.  
  1862.     if (!PyArg_ParseTuple(args, "O:repr", &v))
  1863.         return NULL;
  1864.     return PyObject_Repr(v);
  1865. }
  1866.  
  1867. static char repr_doc[] =
  1868. "repr(object) -> string\n\
  1869. \n\
  1870. Return the canonical string representation of the object.\n\
  1871. For most object types, eval(repr(object)) == object.";
  1872.  
  1873.  
  1874. static PyObject *
  1875. builtin_round(self, args)
  1876.     PyObject *self;
  1877.     PyObject *args;
  1878. {
  1879.     double x;
  1880.     double f;
  1881.     int ndigits = 0;
  1882.     int i;
  1883.  
  1884.     if (!PyArg_ParseTuple(args, "d|i:round", &x, &ndigits))
  1885.             return NULL;
  1886.     f = 1.0;
  1887.     i = abs(ndigits);
  1888.     while  (--i >= 0)
  1889.         f = f*10.0;
  1890.     if (ndigits < 0)
  1891.         x /= f;
  1892.     else
  1893.         x *= f;
  1894.     if (x >= 0.0)
  1895.         x = floor(x + 0.5);
  1896.     else
  1897.         x = ceil(x - 0.5);
  1898.     if (ndigits < 0)
  1899.         x *= f;
  1900.     else
  1901.         x /= f;
  1902.     return PyFloat_FromDouble(x);
  1903. }
  1904.  
  1905. static char round_doc[] =
  1906. "round(number[, ndigits]) -> floating point number\n\
  1907. \n\
  1908. Round a number to a given precision in decimal digits (default 0 digits).\n\
  1909. This always returns a floating point number.  Precision may be negative.";
  1910.  
  1911.  
  1912. static PyObject *
  1913. builtin_str(self, args)
  1914.     PyObject *self;
  1915.     PyObject *args;
  1916. {
  1917.     PyObject *v;
  1918.  
  1919.     if (!PyArg_ParseTuple(args, "O:str", &v))
  1920.         return NULL;
  1921.     return PyObject_Str(v);
  1922. }
  1923.  
  1924. static char str_doc[] =
  1925. "str(object) -> string\n\
  1926. \n\
  1927. Return a nice string representation of the object.\n\
  1928. If the argument is a string, the return value is the same object.";
  1929.  
  1930.  
  1931. static PyObject *
  1932. builtin_tuple(self, args)
  1933.     PyObject *self;
  1934.     PyObject *args;
  1935. {
  1936.     PyObject *v;
  1937.  
  1938.     if (!PyArg_ParseTuple(args, "O:tuple", &v))
  1939.         return NULL;
  1940.     return PySequence_Tuple(v);
  1941. }
  1942.  
  1943. static char tuple_doc[] =
  1944. "tuple(sequence) -> list\n\
  1945. \n\
  1946. Return a tuple whose items are the same as those of the argument sequence.\n\
  1947. If the argument is a tuple, the return value is the same object.";
  1948.  
  1949.  
  1950. static PyObject *
  1951. builtin_type(self, args)
  1952.     PyObject *self;
  1953.     PyObject *args;
  1954. {
  1955.     PyObject *v;
  1956.  
  1957.     if (!PyArg_ParseTuple(args, "O:type", &v))
  1958.         return NULL;
  1959.     v = (PyObject *)v->ob_type;
  1960.     Py_INCREF(v);
  1961.     return v;
  1962. }
  1963.  
  1964. static char type_doc[] =
  1965. "type(object) -> type object\n\
  1966. \n\
  1967. Return the type of the object.";
  1968.  
  1969.  
  1970. static PyObject *
  1971. builtin_vars(self, args)
  1972.     PyObject *self;
  1973.     PyObject *args;
  1974. {
  1975.     PyObject *v = NULL;
  1976.     PyObject *d;
  1977.  
  1978.     if (!PyArg_ParseTuple(args, "|O:vars", &v))
  1979.         return NULL;
  1980.     if (v == NULL) {
  1981.         d = PyEval_GetLocals();
  1982.         if (d == NULL) {
  1983.             if (!PyErr_Occurred())
  1984.                 PyErr_SetString(PyExc_SystemError,
  1985.                         "no locals!?");
  1986.         }
  1987.         else
  1988.             Py_INCREF(d);
  1989.     }
  1990.     else {
  1991.         d = PyObject_GetAttrString(v, "__dict__");
  1992.         if (d == NULL) {
  1993.             PyErr_SetString(PyExc_TypeError,
  1994.                 "vars() argument must have __dict__ attribute");
  1995.             return NULL;
  1996.         }
  1997.     }
  1998.     return d;
  1999. }
  2000.  
  2001. static char vars_doc[] =
  2002. "vars([object]) -> dictionary\n\
  2003. \n\
  2004. Without arguments, equivalent to locals().\n\
  2005. With an argument, equivalent to object.__dict__.";
  2006.  
  2007.  
  2008. static PyObject *
  2009. builtin_isinstance(self, args)
  2010.      PyObject *self;
  2011.      PyObject *args;
  2012. {
  2013.     PyObject *inst;
  2014.     PyObject *cls;
  2015.     int retval;
  2016.  
  2017.     if (!PyArg_ParseTuple(args, "OO", &inst, &cls))
  2018.         return NULL;
  2019.     if (PyType_Check(cls)) {
  2020.         retval = ((PyObject *)(inst->ob_type) == cls);
  2021.     }
  2022.     else {
  2023.         if (!PyClass_Check(cls)) {
  2024.             PyErr_SetString(PyExc_TypeError,
  2025.                     "second argument must be a class");
  2026.             return NULL;
  2027.         }
  2028.  
  2029.         if (!PyInstance_Check(inst))
  2030.             retval = 0;
  2031.         else {
  2032.             PyObject *inclass =
  2033.                 (PyObject*)((PyInstanceObject*)inst)->in_class;
  2034.             retval = PyClass_IsSubclass(inclass, cls);
  2035.         }
  2036.     }
  2037.     return PyInt_FromLong(retval);
  2038. }
  2039.  
  2040. static char isinstance_doc[] =
  2041. "isinstance(object, class-or-type) -> Boolean\n\
  2042. \n\
  2043. Return whether an object is an instance of a class or of a subclass thereof.\n\
  2044. With a type as second argument, return whether that is the object's type.";
  2045.  
  2046.  
  2047. static PyObject *
  2048. builtin_issubclass(self, args)
  2049.      PyObject *self;
  2050.      PyObject *args;
  2051. {
  2052.     PyObject *derived;
  2053.     PyObject *cls;
  2054.     int retval;
  2055.  
  2056.     if (!PyArg_ParseTuple(args, "OO", &derived, &cls))
  2057.         return NULL;
  2058.     if (!PyClass_Check(derived) || !PyClass_Check(cls)) {
  2059.         PyErr_SetString(PyExc_TypeError, "arguments must be classes");
  2060.         return NULL;
  2061.     }
  2062.     /* shortcut */
  2063.     if (!(retval = (derived == cls)))
  2064.         retval = PyClass_IsSubclass(derived, cls);
  2065.  
  2066.     return PyInt_FromLong(retval);
  2067. }
  2068.  
  2069. static char issubclass_doc[] =
  2070. "issubclass(C, B) -> Boolean\n\
  2071. \n\
  2072. Return whether class C is a subclass (i.e., a derived class) of class B.";
  2073.  
  2074.  
  2075. static PyMethodDef builtin_methods[] = {
  2076.     {"__import__",    builtin___import__, 1, import_doc},
  2077.     {"abs",        builtin_abs, 1, abs_doc},
  2078.     {"apply",    builtin_apply, 1, apply_doc},
  2079.     {"buffer",    builtin_buffer, 1, buffer_doc},
  2080.     {"callable",    builtin_callable, 1, callable_doc},
  2081.     {"chr",        builtin_chr, 1, chr_doc},
  2082.     {"cmp",        builtin_cmp, 1, cmp_doc},
  2083.     {"coerce",    builtin_coerce, 1, coerce_doc},
  2084.     {"compile",    builtin_compile, 1, compile_doc},
  2085. #ifndef WITHOUT_COMPLEX
  2086.     {"complex",    builtin_complex, 1, complex_doc},
  2087. #endif
  2088.     {"delattr",    builtin_delattr, 1, delattr_doc},
  2089.     {"dir",        builtin_dir, 1, dir_doc},
  2090.     {"divmod",    builtin_divmod, 1, divmod_doc},
  2091.     {"eval",    builtin_eval, 1, eval_doc},
  2092.     {"execfile",    builtin_execfile, 1, execfile_doc},
  2093.     {"filter",    builtin_filter, 1, filter_doc},
  2094.     {"float",    builtin_float, 1, float_doc},
  2095.     {"getattr",    builtin_getattr, 1, getattr_doc},
  2096.     {"globals",    builtin_globals, 1, globals_doc},
  2097.     {"hasattr",    builtin_hasattr, 1, hasattr_doc},
  2098.     {"hash",    builtin_hash, 1, hash_doc},
  2099.     {"hex",        builtin_hex, 1, hex_doc},
  2100.     {"id",        builtin_id, 1, id_doc},
  2101.     {"input",    builtin_input, 1, input_doc},
  2102.     {"intern",    builtin_intern, 1, intern_doc},
  2103.     {"int",        builtin_int, 1, int_doc},
  2104.     {"isinstance",  builtin_isinstance, 1, isinstance_doc},
  2105.     {"issubclass",  builtin_issubclass, 1, issubclass_doc},
  2106.     {"len",        builtin_len, 1, len_doc},
  2107.     {"list",    builtin_list, 1, list_doc},
  2108.     {"locals",    builtin_locals, 1, locals_doc},
  2109.     {"long",    builtin_long, 1, long_doc},
  2110.     {"map",        builtin_map, 1, map_doc},
  2111.     {"max",        builtin_max, 1, max_doc},
  2112.     {"min",        builtin_min, 1, min_doc},
  2113.     {"oct",        builtin_oct, 1, oct_doc},
  2114.     {"open",    builtin_open, 1, open_doc},
  2115.     {"ord",        builtin_ord, 1, ord_doc},
  2116.     {"pow",        builtin_pow, 1, pow_doc},
  2117.     {"range",    builtin_range, 1, range_doc},
  2118.     {"raw_input",    builtin_raw_input, 1, raw_input_doc},
  2119.     {"reduce",    builtin_reduce, 1, reduce_doc},
  2120.     {"reload",    builtin_reload, 1, reload_doc},
  2121.     {"repr",    builtin_repr, 1, repr_doc},
  2122.     {"round",    builtin_round, 1, round_doc},
  2123.     {"setattr",    builtin_setattr, 1, setattr_doc},
  2124.     {"slice",       builtin_slice, 1, slice_doc},
  2125.     {"str",        builtin_str, 1, str_doc},
  2126.     {"tuple",    builtin_tuple, 1, tuple_doc},
  2127.     {"type",    builtin_type, 1, type_doc},
  2128.     {"vars",    builtin_vars, 1, vars_doc},
  2129.     {"xrange",    builtin_xrange, 1, xrange_doc},
  2130.     {NULL,        NULL},
  2131. };
  2132.  
  2133. /* Predefined exceptions */
  2134.  
  2135. PyObject *PyExc_Exception;
  2136. PyObject *PyExc_StandardError;
  2137. PyObject *PyExc_ArithmeticError;
  2138. PyObject *PyExc_LookupError;
  2139.  
  2140. PyObject *PyExc_AssertionError;
  2141. PyObject *PyExc_AttributeError;
  2142. PyObject *PyExc_EOFError;
  2143. PyObject *PyExc_FloatingPointError;
  2144. PyObject *PyExc_EnvironmentError;
  2145. PyObject *PyExc_IOError;
  2146. PyObject *PyExc_OSError;
  2147. PyObject *PyExc_ImportError;
  2148. PyObject *PyExc_IndexError;
  2149. PyObject *PyExc_KeyError;
  2150. PyObject *PyExc_KeyboardInterrupt;
  2151. PyObject *PyExc_MemoryError;
  2152. PyObject *PyExc_NameError;
  2153. PyObject *PyExc_OverflowError;
  2154. PyObject *PyExc_RuntimeError;
  2155. PyObject *PyExc_NotImplementedError;
  2156. PyObject *PyExc_SyntaxError;
  2157. PyObject *PyExc_SystemError;
  2158. PyObject *PyExc_SystemExit;
  2159. PyObject *PyExc_TypeError;
  2160. PyObject *PyExc_ValueError;
  2161. PyObject *PyExc_ZeroDivisionError;
  2162.  
  2163. PyObject *PyExc_MemoryErrorInst;
  2164.  
  2165. static struct
  2166. {
  2167.     char* name;
  2168.     PyObject** exc;
  2169.     int leaf_exc;
  2170. }
  2171. bltin_exc[] = {
  2172.     {"Exception",          &PyExc_Exception,          0},
  2173.     {"StandardError",      &PyExc_StandardError,      0},
  2174.     {"ArithmeticError",    &PyExc_ArithmeticError,    0},
  2175.     {"LookupError",        &PyExc_LookupError,        0},
  2176.     {"AssertionError",     &PyExc_AssertionError,     1},
  2177.     {"AttributeError",     &PyExc_AttributeError,     1},
  2178.     {"EOFError",           &PyExc_EOFError,           1},
  2179.     {"FloatingPointError", &PyExc_FloatingPointError, 1},
  2180.     {"EnvironmentError",   &PyExc_EnvironmentError,   0},
  2181.     {"IOError",            &PyExc_IOError,            1},
  2182.     {"OSError",            &PyExc_OSError,            1},
  2183.     {"ImportError",        &PyExc_ImportError,        1},
  2184.     {"IndexError",         &PyExc_IndexError,         1},
  2185.     {"KeyError",           &PyExc_KeyError,           1},
  2186.     {"KeyboardInterrupt",  &PyExc_KeyboardInterrupt,  1},
  2187.     {"MemoryError",        &PyExc_MemoryError,        1},
  2188.     {"NameError",          &PyExc_NameError,          1},
  2189.     {"OverflowError",      &PyExc_OverflowError,      1},
  2190.     {"RuntimeError",       &PyExc_RuntimeError,       1},
  2191.      {"NotImplementedError",&PyExc_NotImplementedError,1},
  2192.     {"SyntaxError",        &PyExc_SyntaxError,        1},
  2193.     {"SystemError",        &PyExc_SystemError,        1},
  2194.     {"SystemExit",         &PyExc_SystemExit,         1},
  2195.     {"TypeError",          &PyExc_TypeError,          1},
  2196.     {"ValueError",         &PyExc_ValueError,         1},
  2197.     {"ZeroDivisionError",  &PyExc_ZeroDivisionError,  1},
  2198.     {NULL, NULL}
  2199. };
  2200.  
  2201.  
  2202. /* import exceptions module to extract class exceptions.  on success,
  2203.  * return 1. on failure return 0 which signals _PyBuiltin_Init_2 to fall
  2204.  * back to using old-style string based exceptions.
  2205.  */
  2206. static int
  2207. init_class_exc(dict)
  2208.     PyObject *dict;
  2209. {
  2210.     int i;
  2211.     PyObject *m = PyImport_ImportModule("exceptions");
  2212.     PyObject *args = NULL;
  2213.     PyObject *d = NULL;
  2214.  
  2215.     /* make sure we got the module and its dictionary */
  2216.     if (m == NULL ||
  2217.         (d = PyModule_GetDict(m)) == NULL)
  2218.     {
  2219.         PySys_WriteStderr("'import exceptions' failed; ");
  2220.         if (Py_VerboseFlag) {
  2221.             PySys_WriteStderr("traceback:\n");
  2222.             PyErr_Print();
  2223.         }
  2224.         else {
  2225.             PySys_WriteStderr("use -v for traceback\n");
  2226.         }
  2227.         goto finally;
  2228.     }
  2229.     for (i = 0; bltin_exc[i].name; i++) {
  2230.         /* dig the exception out of the module */
  2231.         PyObject *exc = PyDict_GetItemString(d, bltin_exc[i].name);
  2232.         if (!exc) {
  2233.             PySys_WriteStderr(
  2234.         "Built-in exception class not found: %s.  Library mismatch?\n",
  2235.         bltin_exc[i].name);
  2236.             goto finally;
  2237.         }
  2238.         /* free the old-style exception string object */
  2239.         Py_XDECREF(*bltin_exc[i].exc);
  2240.  
  2241.         /* squirrel away a pointer to the exception */
  2242.         Py_INCREF(exc);
  2243.         *bltin_exc[i].exc = exc;
  2244.  
  2245.         /* and insert the name in the __builtin__ module */
  2246.         if (PyDict_SetItemString(dict, bltin_exc[i].name, exc)) {
  2247.             PySys_WriteStderr(
  2248.                   "Cannot insert exception into __builtin__: %s\n",
  2249.                   bltin_exc[i].name);
  2250.             goto finally;
  2251.         }
  2252.     }
  2253.  
  2254.     /* we need one pre-allocated instance */
  2255.     args = Py_BuildValue("()");
  2256.     if (!args ||
  2257.         !(PyExc_MemoryErrorInst =
  2258.           PyEval_CallObject(PyExc_MemoryError, args)))
  2259.     {
  2260.            PySys_WriteStderr("Cannot pre-allocate MemoryError instance\n");
  2261.            goto finally;
  2262.     }
  2263.     Py_DECREF(args);
  2264.  
  2265.     /* we're done with the exceptions module */
  2266.     Py_DECREF(m);
  2267.  
  2268.     if (PyErr_Occurred()) {
  2269.         PySys_WriteStderr("Cannot initialize standard class exceptions; ");
  2270.         if (Py_VerboseFlag) {
  2271.             PySys_WriteStderr("traceback:\n");
  2272.             PyErr_Print();
  2273.         }
  2274.         else
  2275.             PySys_WriteStderr("use -v for traceback\n");
  2276.         goto finally;
  2277.     }
  2278.     return 1;
  2279.   finally:
  2280.     Py_XDECREF(m);
  2281.     Py_XDECREF(args);
  2282.     PyErr_Clear();
  2283.     return 0;
  2284. }
  2285.  
  2286.  
  2287. static void
  2288. fini_instances()
  2289. {
  2290.     Py_XDECREF(PyExc_MemoryErrorInst);
  2291.     PyExc_MemoryErrorInst = NULL;
  2292. }
  2293.  
  2294.  
  2295. static PyObject *
  2296. newstdexception(dict, name)
  2297.     PyObject *dict;
  2298.     char *name;
  2299. {
  2300.     PyObject *v = PyString_FromString(name);
  2301.     if (v == NULL || PyDict_SetItemString(dict, name, v) != 0)
  2302.         Py_FatalError("Cannot create string-based exceptions");
  2303.     return v;
  2304. }
  2305.  
  2306. static void
  2307. initerrors(dict)
  2308.     PyObject *dict;
  2309. {
  2310.     int i, j;
  2311.     int exccnt = 0;
  2312.     for (i = 0; bltin_exc[i].name; i++, exccnt++) {
  2313.         Py_XDECREF(*bltin_exc[i].exc);
  2314.         if (bltin_exc[i].leaf_exc)
  2315.             *bltin_exc[i].exc =
  2316.                 newstdexception(dict, bltin_exc[i].name);
  2317.     }
  2318.  
  2319.     /* This is kind of bogus because we special case the some of the
  2320.      * new exceptions to be nearly forward compatible.  But this means
  2321.      * we hard code knowledge about exceptions.py into C here.  I don't
  2322.      * have a better solution, though.
  2323.      */
  2324.     PyExc_LookupError = PyTuple_New(2);
  2325.     Py_INCREF(PyExc_IndexError);
  2326.     PyTuple_SET_ITEM(PyExc_LookupError, 0, PyExc_IndexError);
  2327.     Py_INCREF(PyExc_KeyError);
  2328.     PyTuple_SET_ITEM(PyExc_LookupError, 1, PyExc_KeyError);
  2329.     PyDict_SetItemString(dict, "LookupError", PyExc_LookupError);
  2330.  
  2331.     PyExc_ArithmeticError = PyTuple_New(3);
  2332.     Py_INCREF(PyExc_OverflowError);
  2333.     PyTuple_SET_ITEM(PyExc_ArithmeticError, 0, PyExc_OverflowError);
  2334.     Py_INCREF(PyExc_ZeroDivisionError);
  2335.     PyTuple_SET_ITEM(PyExc_ArithmeticError, 1, PyExc_ZeroDivisionError);
  2336.     Py_INCREF(PyExc_FloatingPointError);
  2337.     PyTuple_SET_ITEM(PyExc_ArithmeticError, 2, PyExc_FloatingPointError);
  2338.     PyDict_SetItemString(dict, "ArithmeticError", PyExc_ArithmeticError);
  2339.  
  2340.     PyExc_EnvironmentError = PyTuple_New(2);
  2341.     Py_INCREF(PyExc_IOError);
  2342.     PyTuple_SET_ITEM(PyExc_EnvironmentError, 0, PyExc_IOError);
  2343.     Py_INCREF(PyExc_OSError);
  2344.     PyTuple_SET_ITEM(PyExc_EnvironmentError, 1, PyExc_OSError);
  2345.     PyDict_SetItemString(dict, "EnvironmentError", PyExc_EnvironmentError);
  2346.  
  2347.     /* missing from the StandardError tuple: Exception, StandardError,
  2348.      * and SystemExit
  2349.      */
  2350.     PyExc_StandardError = PyTuple_New(exccnt-3);
  2351.     for (i = 2, j = 0; bltin_exc[i].name; i++) {
  2352.         PyObject *exc = *bltin_exc[i].exc;
  2353.         /* SystemExit is not an error, but it is an exception */
  2354.         if (exc != PyExc_SystemExit) {
  2355.             Py_INCREF(exc);
  2356.             PyTuple_SET_ITEM(PyExc_StandardError, j++, exc);
  2357.         }
  2358.     }
  2359.     PyDict_SetItemString(dict, "StandardError", PyExc_StandardError);
  2360.  
  2361.     /* Exception is a 2-tuple */
  2362.     PyExc_Exception = PyTuple_New(2);
  2363.     Py_INCREF(PyExc_SystemExit);
  2364.     PyTuple_SET_ITEM(PyExc_Exception, 0, PyExc_SystemExit);
  2365.     Py_INCREF(PyExc_StandardError);
  2366.     PyTuple_SET_ITEM(PyExc_Exception, 1, PyExc_StandardError);
  2367.     PyDict_SetItemString(dict, "Exception", PyExc_Exception);
  2368.     
  2369.     if (PyErr_Occurred())
  2370.           Py_FatalError("Could not initialize built-in string exceptions");
  2371. }
  2372.  
  2373.  
  2374. static void
  2375. finierrors()
  2376. {
  2377.     int i;
  2378.     for (i = 0; bltin_exc[i].name; i++) {
  2379.         PyObject *exc = *bltin_exc[i].exc;
  2380.         Py_XDECREF(exc);
  2381.         *bltin_exc[i].exc = NULL;
  2382.     }
  2383. }
  2384.  
  2385. static char builtin_doc[] =
  2386. "Built-in functions, exceptions, and other objects.\n\
  2387. \n\
  2388. Noteworthy: None is the `nil' object; Ellipsis represents `...' in slices.";
  2389.  
  2390. PyObject *
  2391. _PyBuiltin_Init_1()
  2392. {
  2393.     PyObject *mod, *dict;
  2394.     mod = Py_InitModule4("__builtin__", builtin_methods,
  2395.                  builtin_doc, (PyObject *)NULL,
  2396.                  PYTHON_API_VERSION);
  2397.     if (mod == NULL)
  2398.         return NULL;
  2399.     dict = PyModule_GetDict(mod);
  2400.     initerrors(dict);
  2401.     if (PyDict_SetItemString(dict, "None", Py_None) < 0)
  2402.         return NULL;
  2403.     if (PyDict_SetItemString(dict, "Ellipsis", Py_Ellipsis) < 0)
  2404.         return NULL;
  2405.     if (PyDict_SetItemString(dict, "__debug__",
  2406.               PyInt_FromLong(Py_OptimizeFlag == 0)) < 0)
  2407.         return NULL;
  2408.  
  2409.     return mod;
  2410. }
  2411.  
  2412. void
  2413. _PyBuiltin_Init_2(dict)
  2414.     PyObject *dict;
  2415. {
  2416.     /* if Python was started with -X, initialize the class exceptions */
  2417.     if (Py_UseClassExceptionsFlag) {
  2418.         if (!init_class_exc(dict)) {
  2419.             /* class based exceptions could not be
  2420.              * initialized. Fall back to using string based
  2421.              * exceptions.
  2422.              */
  2423.             PySys_WriteStderr(
  2424.             "Warning!  Falling back to string-based exceptions\n");
  2425.             initerrors(dict);
  2426.         }
  2427.     }
  2428. }
  2429.  
  2430.  
  2431. void
  2432. _PyBuiltin_Fini_1()
  2433. {
  2434.     fini_instances();
  2435. }
  2436.  
  2437.  
  2438. void
  2439. _PyBuiltin_Fini_2()
  2440. {
  2441.     finierrors();
  2442. }
  2443.  
  2444.  
  2445. /* Helper for filter(): filter a tuple through a function */
  2446.  
  2447. static PyObject *
  2448. filtertuple(func, tuple)
  2449.     PyObject *func;
  2450.     PyObject *tuple;
  2451. {
  2452.     PyObject *result;
  2453.     register int i, j;
  2454.     int len = PyTuple_Size(tuple);
  2455.  
  2456.     if (len == 0) {
  2457.         Py_INCREF(tuple);
  2458.         return tuple;
  2459.     }
  2460.  
  2461.     if ((result = PyTuple_New(len)) == NULL)
  2462.         return NULL;
  2463.  
  2464.     for (i = j = 0; i < len; ++i) {
  2465.         PyObject *item, *good;
  2466.         int ok;
  2467.  
  2468.         if ((item = PyTuple_GetItem(tuple, i)) == NULL)
  2469.             goto Fail_1;
  2470.         if (func == Py_None) {
  2471.             Py_INCREF(item);
  2472.             good = item;
  2473.         }
  2474.         else {
  2475.             PyObject *arg = Py_BuildValue("(O)", item);
  2476.             if (arg == NULL)
  2477.                 goto Fail_1;
  2478.             good = PyEval_CallObject(func, arg);
  2479.             Py_DECREF(arg);
  2480.             if (good == NULL)
  2481.                 goto Fail_1;
  2482.         }
  2483.         ok = PyObject_IsTrue(good);
  2484.         Py_DECREF(good);
  2485.         if (ok) {
  2486.             Py_INCREF(item);
  2487.             if (PyTuple_SetItem(result, j++, item) < 0)
  2488.                 goto Fail_1;
  2489.         }
  2490.     }
  2491.  
  2492.     if (_PyTuple_Resize(&result, j, 0) < 0)
  2493.         return NULL;
  2494.  
  2495.     return result;
  2496.  
  2497. Fail_1:
  2498.     Py_DECREF(result);
  2499.     return NULL;
  2500. }
  2501.  
  2502.  
  2503. /* Helper for filter(): filter a string through a function */
  2504.  
  2505. static PyObject *
  2506. filterstring(func, strobj)
  2507.     PyObject *func;
  2508.     PyObject *strobj;
  2509. {
  2510.     PyObject *result;
  2511.     register int i, j;
  2512.     int len = PyString_Size(strobj);
  2513.  
  2514.     if (func == Py_None) {
  2515.         /* No character is ever false -- share input string */
  2516.         Py_INCREF(strobj);
  2517.         return strobj;
  2518.     }
  2519.     if ((result = PyString_FromStringAndSize(NULL, len)) == NULL)
  2520.         return NULL;
  2521.  
  2522.     for (i = j = 0; i < len; ++i) {
  2523.         PyObject *item, *arg, *good;
  2524.         int ok;
  2525.  
  2526.         item = (*strobj->ob_type->tp_as_sequence->sq_item)(strobj, i);
  2527.         if (item == NULL)
  2528.             goto Fail_1;
  2529.         arg = Py_BuildValue("(O)", item);
  2530.         Py_DECREF(item);
  2531.         if (arg == NULL)
  2532.             goto Fail_1;
  2533.         good = PyEval_CallObject(func, arg);
  2534.         Py_DECREF(arg);
  2535.         if (good == NULL)
  2536.             goto Fail_1;
  2537.         ok = PyObject_IsTrue(good);
  2538.         Py_DECREF(good);
  2539.         if (ok)
  2540.             PyString_AS_STRING((PyStringObject *)result)[j++] =
  2541.                 PyString_AS_STRING((PyStringObject *)item)[0];
  2542.     }
  2543.  
  2544.     if (j < len && _PyString_Resize(&result, j) < 0)
  2545.         return NULL;
  2546.  
  2547.     return result;
  2548.  
  2549. Fail_1:
  2550.     Py_DECREF(result);
  2551.     return NULL;
  2552. }
  2553.